Release notes

• Adds draft release notes for KubeArmor v1.6.8 detailing new features such as username inclusion in host logs, container runtime socket selection via Helm, and workload resource defaults.
• Documents miscellaneous updates including CI workflow corrections, LSM ordering control in tests, host-only run enhancements, dependency updates, and static analysis noise reduction.
• Includes bug fix documentation focusing on concurrency improvements in policy handling, thread-safe alert throttling, improved container runtime detection, manifest generation fixes, and RHEL9 build gating adjustments.
• Corrects the heading for v1.6.8 release notes from '## v1.6.8' to '## v1.6.8 Release' to improve clarity and consistency.
• Updates the v1.6.8 release notes heading to '## v1.6.8 Release' for improved clarity.
• Patches the release notes JSON block formatting to use JSONC for better readability and maintainability.
• Replaces the JSON block in the v1.6.8 release notes with explicit bulleted lists describing new features, bug fixes, and miscellaneous updates, enhancing readability.
• Hides the original JSON content within HTML comment blocks to maintain source data without cluttering the rendered notes.
• Deletes the 'getting-started/release-notes/v1.6.md' file to remove previous release notes artifacts.
• Refines release notes by recreating the v1.6.8 section without JSON artifacts for cleaner presentation.
• Restores the v1.6 release notes file with the structured v1.6.8 release notes section including bulleted entries for all changes and the extended detailed v1.6 release overview.
• Adds detailed documentation in the deployment guide on setting the CRI socket file explicitly via Helm with examples.
• Clarifies and corrects the Helm socket-file configuration guidance, including advice on helm value keys, flag usage, and version-specific considerations.
• Adds warnings and notes explaining non-prescriptive usage of socket-file Helm options and linking to upstream Helm chart resources for accurate configuration.
• Enhances user instructions with examples to avoid unverified or incorrect Helm key settings for socket-file configuration.
• Includes updated sample policy examples, CLI installation instructions, and troubleshooting notes related to deployment and runtime policy enforcement.

Deployment Guide and Event Logging Documentation

• Adds detailed instructions to the deployment guide on configuring the CRI socket path explicitly in Helm deployments, emphasizing caution about Helm version variations and unreliability of certain Helm key paths.
• Incorporates warning hints about the variability of Helm chart versions impacting the socket-file flag's effectiveness and recommends consulting upstream Helm chart documentation.
• Introduces examples of Helm commands for deploying KubeArmor Operator with appropriate socket-file settings.
• Expands documentation of KubeArmor logs by adding a comprehensive new page explaining supported event formats, container telemetry field structures, and specifically the structured 'EventData' field derived from parsed syscall and network data.
• Provides detailed protobuf message schema excerpts and Go implementation summaries illustrating how logs and alerts are formatted, transmitted via gRPC, and handled by clients.
• Enhances understanding of the Log Feeder component that streams policy enforcement, telemetry, and alert events in real-time to clients via gRPC, supporting tools like karmor CLI and integration with SIEM systems.
• Documents examples of various event types (process, file, network) in JSON to illustrate field usage and parsing logic around EventData for security monitoring purposes.

This covers 13 commits.

Interaction Instructions

This PR was generated by Doc Holiday and is ready to be iterated on.

Leave comments on this pull request in plain English to guide Doc Holiday's next steps.
You might ask to:

• Update or rewrite documentation
• Create or update release notes
• Remove sections or files
• Merge this PR with another Doc Holiday PR

Examples:

• @doc.holiday update these docs to follow my style guide: https://link.to/style-guide
• @doc.holiday write new documentation about quantum compute and how its steam generates a 429
• @doc.holiday combine this PR with #404
• @doc.holiday delete this file: release-notes/file.md

This was opened from: https://github.com/kubearmor/KubeArmor/releases/tag/v1.6.11

The publication for this is: internal-docs